Skip to content

docs: tidy comments, docstrings and the STATUS caveats - #14

Merged
planetf1 merged 2 commits into
mainfrom
docs/tidy-comments-and-docs
Oct 25, 2026
Merged

planetf1 merged 2 commits into
mainfrom
docs/tidy-comments-and-docs

Conversation

@planetf1

Copy link
Copy Markdown
Collaborator

Comments and docstrings are shorter and no longer use dashes as separators. No behaviour change: the AST of every touched Python file is identical once docstrings are removed, and the suite passes (226 passed, 4 skipped). docs/STATUS.md gets the Decision Index caveats split into short bullets.

Stacked on #13 (base is its branch) so the two do not conflict; retarget to main after #13 merges. Draft.

Base automatically changed from feat/image-variants-and-build-args to main October 25, 2026 20:47
Comments and docstrings only; the AST of every touched file is unchanged
once docstrings are removed, and the suite passes (226 passed, 4 skipped).

Assisted-by: Claude Code
Signed-off-by: Nigel Jones <jonesn@uk.ibm.com>
Assisted-by: Claude Code
Signed-off-by: Nigel Jones <jonesn@uk.ibm.com>
@planetf1
planetf1 force-pushed the docs/tidy-comments-and-docs branch from 6a42330 to e1f4050 Compare October 25, 2026 20:49
@planetf1
planetf1 marked this pull request as ready for review October 25, 2026 20:50
@planetf1
planetf1 merged commit 308e90b into main Oct 25, 2026
3 checks passed
@planetf1
planetf1 deleted the docs/tidy-comments-and-docs branch October 25, 2026 20:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant